{{tag>wiki}}
----

====== Les « tags » ======

Dans la documentation, les tags permettent de créer des liens entre toutes les pages, ainsi une page sans tags est une page qui sera très peu consultée et donc inutile à moins d'avoir d'autres pages qui pointent vers elle, c'est pourquoi il est nécessaire d'ajouter le champ des tags avec les tags appropriés, bien évidemment avec une orthographe correcte (accents y compris) et au singulier.

Ces tags permettent de construire des portails associés où toutes les pages présentant un tag sont listées.

===== Syntaxe =====

Pour utiliser des //tags// (mots-clés) dans les pages du wiki :

<code>{{tag>liste des tags}}</code>

Les tags de cette //liste des tags// sont séparés par des espaces. Pour inclure une espace dans le nom du tag, remplacez-la par un tiret bas. Vous pouvez voir une liste des tags utilisés dans la documentation sur la page [[:catégories]].


===== Recommandations =====

  * Les tags devant être accentués le sont. Exemples : [[:matériel]], [[:système]], [[:sécurité]], etc.

<code>{{tag>matériel système sécurité}}</code>

  * Les tags doivent être intégralement écrits en minuscule, excepté le tag « **BROUILLON** » afin qu'il soit visible. Les tags des versions d'Ubuntu peuvent prendre une majuscule.

  * Les tags de versions (Dapper, Jaunty, Karmic, Lucid, Maverick, ...) correspondent aux versions pour lesquelles la page est valide; ils sont utiles pour toutes les pages de la documentation sauf les [[:portail|portails]]. On utilise uniquement l'adjectif du nom de code de la version.

  * Les tags doivent suivre l'ordre suivant :

<code>{{tag><Versions> <domaine_principal> <domaines spécifiques> <autres_tags> <tutoriel si c'est un tutoriel ou autre> BROUILLON}}</code>

  * On fait suivre la liste des tags d'un trait pour bien séparer du texte grâce à la syntaxe :
<code>----</code>
Ce qui donne
----


===== Tags particuliers =====
Pour le fonctionnement interne de la documentation certains tags peuvent être placés sur des pages spécifiques afin d'attirer l'attention.

Ces tags sont :
  * Brouillon -- pour les pages en cours de rédaction,
  * vétuste -- pour les pages n'ayant pas d'informations récentes et n'ayant pas été validées pour une version encore supportée,
  * à_supprimer -- pour les pages que l'ont pense supprimer mais auquelles ont attend une éventuelle ré-écriture.

Voir le [[:wiki/chantiers#gestions_des_tags|chantier des tags]]

===== Les « topics » =====

Pour lister les pages ayant un tag particulier utilisez cette syntaxe :

<code>{{topic>nom_du_tag}}</code>

Si vous venez d'ajouter un tag à une page et qu'une page listant les pages contenant ce tag //via// « le wikicode topic » ne contient pas votre page, cela est peut-être dû au fait que votre page ne contient pas de titre de niveau 1. Veillez à bien structurer votre page de manière sémantique (c'est-à-dire avec des titres, etc.).

D'autres syntaxes sont également possibles :

  {{topic>tag1 +tag2}}           (tag1 ET tag2)
  {{topic>tag1 -tag2}}           (tag1 SAUF tag2)
  {{topic>tag1 tag2}}            (tag1 OU tag2)

Pour plus de détails, se référer à l'[[doku>plugin:tag#topic|aide de l'élément Topic sur DokuWiki]].
